########################################################################
#                                                                      #
#   VE LIVE RACK  -  IMPORTANTE: LEER ANTES DE ABRIR                    #
#   VE LIVE RACK  -  IMPORTANT: READ BEFORE OPENING                    #
#                                                                      #
#   ESPANOL  ->  ver abajo                                             #
#   ENGLISH  ->  scroll down to the ENGLISH section                    #
#                                                                      #
########################################################################



========================================================================
||                            E S P A N O L                           ||
========================================================================

VE Live Rack todavia NO esta firmado/notarizado (se hara mas adelante).
Por eso tu sistema puede mostrar avisos o marcar el programa como
amenaza. ES UN FALSO POSITIVO: la aplicacion es segura. Ocurre porque el
archivo es nuevo y no esta firmado todavia.

Segui los pasos de tu sistema operativo UNA sola vez.


------------------------------------------------------------------------
W I N D O W S
------------------------------------------------------------------------

PASO 1 - Excluir la carpeta en Windows Defender (HACELO PRIMERO)
   Defender puede borrar el archivo apenas lo descargas, asi que primero
   crea la exclusion:
   1. Abri "Seguridad de Windows".
   2. "Proteccion antivirus y contra amenazas".
   3. "Administrar la configuracion".
   4. Baja hasta "Exclusiones" -> "Agregar o quitar exclusiones".
   5. "Agregar una exclusion" -> "Carpeta" -> elegi la carpeta donde vas
      a guardar VE Live Rack.
   >> Guarda el .exe DENTRO de esa carpeta.

   Si Defender YA borro el archivo:
   "Seguridad de Windows" -> "Proteccion antivirus y contra amenazas" ->
   "Historial de proteccion" -> busca VE Live Rack -> "Acciones" ->
   "Permitir" o "Restaurar". Despues crea la exclusion y vuelve a copiar
   el .exe ahi dentro.

PASO 2 - Desbloquear el archivo (si lo bajaste de internet)
   Clic derecho en el .exe -> "Propiedades". Si abajo aparece
   "Seguridad: este archivo proviene de otro equipo...", marca
   "Desbloquear" -> "Aplicar" -> "Aceptar".

PASO 3 - Instalar el componente de Windows que necesita el programa (UNA vez)
   VE Live Rack necesita el "Microsoft Visual C++ Redistributable (x64)".
   Si tu Windows no lo tiene, el programa NO abre (das doble clic y no
   pasa nada, sin ningun aviso). Se instala una sola vez por computadora.
   1. En la carpeta, doble clic en "vc_redist.x64.exe" (viene incluido).
   2. Marca "Acepto los terminos" -> "Instalar" -> al terminar "Cerrar".
      (Si dice que ya esta instalado, perfecto: cierra y sigue.)
   3. Si no encuentras el archivo, descargalo de Microsoft (oficial):
      https://aka.ms/vs/17/release/vc_redist.x64.exe

PASO 4 - Abrir por primera vez
   1. Doble clic en el .exe.
   2. Si aparece "Windows protegio tu PC" (SmartScreen):
      -> "Mas informacion" -> "Ejecutar de todas formas".
   3. Aparecera el aviso de administrador (UAC): "Quieres permitir que
      esta aplicacion haga cambios...?" -> "SI".
      (VE Live Rack usa permiso de administrador para correr el audio con
      la maxima prioridad del sistema = mejor estabilidad y menor
      latencia. Te lo va a pedir cada vez que lo abras; es normal.)


------------------------------------------------------------------------
M A C
------------------------------------------------------------------------
La primera vez, macOS lo bloquea con un mensaje del tipo "no se puede
abrir porque Apple no puede comprobar..." o "esta danado". NO esta
danado: solo le falta la firma de Apple. Se arregla en un minuto.

PASO 1 - Mover la app a Aplicaciones
   Abri el .dmg y arrastra la app de VE Live Rack a "Aplicaciones".

PASO 2 - Quitar el bloqueo con Terminal (lo mas facil y seguro)
   1. Abri "Terminal" (Aplicaciones -> Utilidades; o con Spotlight,
      Cmd + barra espaciadora, escribi "Terminal").
   2. Escribi EXACTAMENTE esto, con un espacio al final (SIN apretar
      Enter todavia):

         xattr -dr com.apple.quarantine

   3. Arrastra el icono de VE Live Rack (desde Aplicaciones) y soltalo
      sobre la ventana de Terminal -> se pega sola la ruta correcta.
   4. Ahora si, apreta Enter.
      (Si pide contrasena o da error de permisos, vuelve a escribir lo
      mismo empezando con  sudo  y un espacio adelante, Enter, y escribi
      la contrasena de tu Mac. No se ve mientras la escribis: es normal.)

PASO 3 - Abrir
   1. Doble clic en VE Live Rack. Ya deberia abrir sin avisos.
   2. La primera vez que use el audio, macOS pedira permiso para el
      microfono / entrada de audio -> "Permitir" (sin esto no entra
      audio).

   Si aun asi no abre: doble clic (te la bloquea) -> "Ajustes del
   Sistema" -> "Privacidad y seguridad" -> baja hasta el final ->
   "Abrir de todas formas".


Nota: los mismos pasos sirven para el instalador de los plugins
(VE Plugins Bundle), que tampoco esta firmado todavia.

Dudas: josevallenotti@gmail.com  /  josevallenotti.com



========================================================================
||                            E N G L I S H                           ||
========================================================================

VE Live Rack is NOT signed/notarized yet (this will be done later). Your
system may therefore show warnings or flag the program as a threat. THIS
IS A FALSE POSITIVE: the application is safe. It happens because the file
is new and not signed yet.

Follow the steps for your operating system ONCE.


------------------------------------------------------------------------
W I N D O W S
------------------------------------------------------------------------

STEP 1 - Exclude the folder in Windows Defender (DO THIS FIRST)
   Defender may delete the file as soon as you download it, so create the
   exclusion first:
   1. Open "Windows Security".
   2. "Virus & threat protection".
   3. "Manage settings".
   4. Scroll to "Exclusions" -> "Add or remove exclusions".
   5. "Add an exclusion" -> "Folder" -> choose the folder where you will
      keep VE Live Rack.
   >> Save the .exe INSIDE that folder.

   If Defender ALREADY deleted the file:
   "Windows Security" -> "Virus & threat protection" -> "Protection
   history" -> find VE Live Rack -> "Actions" -> "Allow" or "Restore".
   Then create the folder exclusion and copy the .exe back into it.

STEP 2 - Unblock the file (if you downloaded it from the internet)
   Right-click the .exe -> "Properties". If you see "Security: This file
   came from another computer..." at the bottom, tick "Unblock" ->
   "Apply" -> "OK".

STEP 3 - Install the Windows component the program needs (ONCE)
   VE Live Rack needs the "Microsoft Visual C++ Redistributable (x64)".
   If your Windows does not have it, the program will NOT open (you
   double-click and nothing happens, with no message). Install it once
   per computer.
   1. In the folder, double-click "vc_redist.x64.exe" (included).
   2. Tick "I agree" -> "Install" -> when finished "Close".
      (If it says it is already installed, great: close and continue.)
   3. If you cannot find the file, download it from Microsoft (official):
      https://aka.ms/vs/17/release/vc_redist.x64.exe

STEP 4 - Open it for the first time
   1. Double-click the .exe.
   2. If "Windows protected your PC" appears (SmartScreen):
      -> "More info" -> "Run anyway".
   3. The administrator prompt (UAC) appears: "Do you want to allow this
      app to make changes to your device?" -> "YES".
      (VE Live Rack uses administrator permission to run the audio at the
      system's highest priority = better stability and lower latency. It
      will ask every time you open it; this is normal.)


------------------------------------------------------------------------
M A C
------------------------------------------------------------------------
The first time, macOS blocks it with a message like "can't be opened
because Apple cannot check it..." or "is damaged". It is NOT damaged: it
is simply missing Apple's signature. It takes one minute to fix.

STEP 1 - Move the app to Applications
   Open the .dmg and drag the VE Live Rack app into "Applications".

STEP 2 - Remove the block using Terminal (easiest and safest way)
   1. Open "Terminal" (Applications -> Utilities; or with Spotlight,
      Cmd + Space, type "Terminal").
   2. Type EXACTLY this, with a space at the end (do NOT press Enter yet):

         xattr -dr com.apple.quarantine

   3. Drag the VE Live Rack icon (from Applications) and drop it onto the
      Terminal window -> the correct path is pasted automatically.
   4. Now press Enter.
      (If it asks for a password or gives a permissions error, type the
      same line again starting with  sudo  and a space, press Enter, and
      type your Mac password. It will not show on screen as you type:
      that is normal.)

STEP 3 - Open it
   1. Double-click VE Live Rack. It should now open with no warnings.
   2. The first time it uses audio, macOS asks for microphone / audio
      input permission -> "Allow" (without it, no audio comes in).

   If it still will not open: double-click it (it gets blocked) ->
   "System Settings" -> "Privacy & Security" -> scroll to the bottom ->
   "Open Anyway".


Note: the same steps apply to the plugins installer (VE Plugins Bundle),
which is not signed yet either.

Questions: josevallenotti@gmail.com  /  josevallenotti.com
########################################################################
